home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / Newton Platform Info / Newton 2.0 Sample Code / Desktop Connectivity / SoupDrink-2 / SoupDrink-Mac-2 / README.SoupDrink < prev    next >
Encoding:
Text File  |  1996-02-09  |  2.2 KB  |  48 lines  |  [TEXT/R*ch]
  1. /*
  2. **      Newton Developer Technical Support Sample Code
  3. **
  4. **      SoupDrink, code to demonstrate use of the CDILs and FDILs
  5. **
  6. **      by David Fedor, Rob Langhorne and Christopher Bell
  7. **
  8. **      Copyright © 1995-1996 by Apple Computer, Inc.  All rights reserved.
  9. **
  10. **      You may incorporate this sample code into your applications without
  11. **      restriction.  This sample code has been provided "AS IS" and the
  12. **      responsibility for its operation is 100% yours.  You are not
  13. **      permitted to modify and redistribute the source as "DTS Sample Code."
  14. **      If you are going to re-distribute the source, we require that you
  15. **      make it clear in the source that the code was descended from
  16. **      Apple-provided sample code, but that you've made changes.
  17. */
  18.  
  19.  
  20. This is a complete MacOS application which demonstrates use of the CDILs and
  21. the FDILs.  It is designed to communicate with the Newton SoupDrink
  22. package, which you probably also got with this sample code.
  23.  
  24. Most of the interesting DIL code can be found in the file Engine.c, which
  25. holds the cross-platform code which makes most of the DIL API calls.
  26.  
  27. The routine SetupPortMenu() demonstrates how to dynamically find the names
  28. of the available ports - these can be different on different models of MacOS
  29. computers, and change in localized versions of the Macintosh System.
  30.  
  31. The SoupDrink application has two test scripts.  The first, "Soup Drink",
  32. will read the entire contents of any soup on the Newton device.  It does
  33. this by sending a command to the Newton device indicating the name of the
  34. soup to read, and then repeatedly reading frames which are sent from the
  35. Newton application, converting them to text, and writing them to the file
  36. SoupData.out.
  37.  
  38. The second test script, "Add New Name Card", constructs a name card frame
  39. for the built-in Names application, and sends it to the Newton device.  The
  40. Newton SoupDrink application adds it to the Names soup.
  41.  
  42.  
  43. Note that the CSTR resources found in the file SoupDrink.rsrc must be
  44. linked in to every DIL application.  They are used internally by the CDIL
  45. to find the appropriate Communications Toolbox files.  These CSTR resources
  46. can also be found in the file CSTR.rsrc, which does not contain the
  47. SoupDrink-specific resources.
  48.